home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / bench / RCS / bench.man,v < prev    next >
Text File  |  1990-02-16  |  4KB  |  123 lines
  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     90.02.16.11.10.44;  author jhh;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     89.01.06.09.52.11;  author brent;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @Man page for the bench program
  22. @
  23.  
  24.  
  25. 1.2
  26. log
  27. @Option to start server on signal
  28. @
  29. text
  30. @' $Header: /a/newcmds/bench/RCS/bench.man,v 1.1 89/01/06 09:52:11 brent Exp $ SPRITE (Berkeley)
  31. .so \*(]ltmac.sprite
  32. .HS BENCH cmds
  33. .BS
  34. .SH NAME
  35. bench \- Benchmark harness that coordinates multiple processes
  36. .SH SYNOPSIS
  37. \fBbench\fR [\fIoptions\fR] \fB-c\fP \fIcommand\fP
  38. .br
  39. \fBbench\fR \fB\-M\fP [\fIoptions\fR]
  40. .SH "OPTIONS"
  41. .IP "\fB\-M \fInumClients\fR" 14
  42. Run as master of the number of clients indicated.
  43. The master bench process should be started before any slaves.
  44. .IP "\fB\-S\fR" 14
  45. Run as a slave.  Use \fB-c\fP to specify a command.  The slave
  46. process will wait until all other slaves have registered with
  47. the master before executing their benchmark.
  48. .IP "\fB\-c \fIcommand args ...\fR" 14
  49. Follow this with the command to benchmark.  Execution search paths
  50. are not used (yet).  The command can be followed with any required arguments.
  51. .IP "\fB\-p\fR" 14
  52. Name of the pseudo-device used for coordination.
  53. .IP "\fB\-o \fIoutfile\fR" 14
  54. Output file in which execution statistics are placed.
  55. .IP "\fB\-f\fR" 14
  56. Flush the file system cache before executing the benchmark.
  57. .IP "\fB\-x\fR" 14
  58. Disable all system tracing before executing the benchmark.
  59. .IP "\fB\-h\fR" 14
  60. Enable taking of RPC timing histograms.  This is ok with -x.
  61. .IP "\fB\-d\fR" 14
  62. Don't sync the file system cache at the end of the benchmark.  Normally
  63. this is done after the benchmark completes and before the file system
  64. I/O statistics are taken.
  65. .IP "\fB\-s\fR" 14
  66. Use signals instead of pseudo-devices for rendez-vous.
  67. .IP "\fB\-P \fIseconds\fR" 14
  68. Pause for some seconds before getting the final statistics.  Only
  69. applies to the master bench process.
  70. .IP "\fB\-w\fR" 14
  71. Causes the master process to wait for a USR1 signal before it allows the
  72. slaves to begin running.  This option must be used with the \fI-M\fR option,
  73. and cannot be used with the \fI-s\fR option.
  74. .BE
  75.  
  76. .SH DESCRIPTION
  77. .PP
  78. Bench is a harness for other programs that executes them and
  79. takes system statistics.
  80. The command to benchmark follows the \fB-c\fP option.  Currently
  81. bench does not used the execution search path, so the command
  82. has to be a valid pathname.  (This should be fixed!)
  83. In its simplest form (no \fB-S\fP or \fB-M\fP) bench executes a
  84. single process and generates output to ``bench.out'' or
  85. to the file specified by the -o option.
  86. The default behavior is that the execution time and CPU utilization
  87. are recorded after the benchmarked process completes,
  88. then the file system cache is written back and
  89. file system statistics are recorded.
  90. The file system cache can be flushed before the benchmark using
  91. the \fB-f\fP option.  The cache write-back at the end of the
  92. run can be disabled with the \fB-d\fP option.  The \fB-x\fP option
  93. turns off various kernel tracing that can slow down execution.
  94. .PP
  95. Multiple processes can be coordinated using the
  96. \fB-M\fP and \fB-S\fP options.  First a master bench process is
  97. started with the \fB-M\fP option.  This option is followed by an
  98. integer that indicates the number of slaves to expect.  The
  99. master process creates a pseudo-device that will be used to
  100. coordinate the slaves.  Each slave benchmark is started
  101. using the \fB-S\fP option.  The slaves contact the master,
  102. and after they all make contact the master lets them proceed.
  103. The master bench process also takes system statistics during
  104. the execution of all the slaves.  It is generally run on
  105. the file server in order to measure the load presented by the slaves.
  106. Note that the master doesn't run a command itself, so no \fB-c\fP
  107. argument is needed with \fB-M\fP.
  108. .SH KEYWORDS
  109. benchmark, statistics, timing
  110. @
  111.  
  112.  
  113. 1.1
  114. log
  115. @Initial revision
  116. @
  117. text
  118. @d1 1
  119. a1 1
  120. ' $Header: /a/newcmds/prefix/RCS/prefix.man,v 1.2 88/12/30 10:08:40 ouster Exp $ SPRITE (Berkeley)
  121. d41 4
  122. @
  123.